home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 426.lha / SCM / SCM documentation (.txt) < prev    next >
Amiga ProWrite Document  |  1990-10-02  |  9KB  |  74 lines

  1. WORDFONT
  2. diamond
  3. diamond
  4. "% $!#
  5. SCREEN COLOR MODIFIER
  6. by Jean-Marc NOGIER
  7. (release 1.0)
  8. 3(First, I'd like to apologize for my poor english.)
  9. |This utility is public domain freeware. Everybody that could find an interest in this program can copy it and use it freely.TEXT
  10. SCM stands for "Screen Color Modifier". It allows you to change the colors of any (didn't check fully for HAM screen, and can't check for halfbrite screen) opened screen under Intuition.TEXT
  11. tI created it to be able to change the colors of program that do not support user color modification (e.g. Sculpt3D).TEXT
  12. ?Then the modified colors can be saved to disk to be used later.
  13. zSCL stands for "Screen color Loader". It allows you to load some colors to a specified screen from a file saved under SCM.TEXT
  14. SCL is smaller and uses less memory than SCM. I keep it separated from SCM for these reasons, and also because I was not able to use overlays under AmigaDOS.
  15. TSCL waits for the specified screen to be opened, then changes its colors, and exits.TEXT
  16. $The procedure to use SCM and SCL is:TEXT
  17. =- load the application the screen colors have to be modified,
  18. )- load SCM from the CLI or the WorkBench,
  19. - modify the colors under SCM,TEXT
  20. %- save color modifications to a file.
  21. At a later use:
  22. .- load SCL from the CLI specifying the screen,TEXT
  23. - load the application,
  24. +- look at the screen colors being modified.
  25. {SCM and SCL were written on a NTSC Amiga 1000, using the Lattice C compiler (release 5.04), and PowerWindows (release 2.5).
  26. I didn't check the PD libraries to see if a similar program is already available (excepted the Palette program on the Workbench disk), but anyway if there is enough people interested in SCM & SCL, I may update them later.
  27. I know the code size is too big (I'm not a professional), that I did not check all possibilities (but my time is limited). So if you discover a bug and would like it to be fixed, you can mail me a letter at the following address, I'll try to find some time to answer you.
  28. :address:    Jean-Marc NOGIER        in FRANCE:     BAL JMN on Sgt FLAMFSCC
  29. '        30 Bd. de La Paix                 (1 39 55 84 59)
  30.         92400 COURBEVOIETEXT
  31.                  FRANCE
  32. SCM description
  33. To run SCM click on its icon, or type "SCM" at the CLI prompt. A new screen which name is "Screen Color Modifier" is being displayed at the bottom of the current screen (usually the Workbench screen). It is lo-res and features a title bar to drag it and 2 depth arrangement gadgets. The window opened in this screen is called "Screen Color Modifier" (well that's free advertisement space) and features 2 to 32 color gadgets on the left, the color currently selected, 3 RGB sliders to modify the selected color, a gadget called "OK" to save your changes, a gadget called "NO" to undo your modifications, and 2 arrows to allow you to find the screen the colors of which you want to modify.
  34. 0First, click once on the down arrow to display the next screen name. If no other screen than the Workbench is opened, then you should see SCM screen name. Otherwise the next screen name in Intuition list is displayed in the string gadget. You can click on the down arrow until you reach the last screen. TEXT
  35. tNow click on the upper arrow to display the previous screen name and continue until you reach the first screen name.TEXT
  36. {Since screens are linked by Intuition if you change screen display order when using SCM, you may have to search forward, then backward until you find that screen name. Notice that clicking on the arrow gadget display the screen name, but doesn't display the screen. You need to find the screen using depth arrangement gadgets if you want to look at the modifications you've made.
  37. Click on the gadget colors (from 2 to 32 gadgets) to select the color you want to modify. The color selected appears in the large rectangle between the color gadget and the RGB sliders.
  38. gNotice that when you select another screen the number of color gadgets is adjusted to the screen depth.
  39. Modify the selected color using the RGB sliders as you would do in Preferences. The amount of red, green and blue are displayed right to the corresponding sliders (from 0 to 15).TEXT
  40. JThe changes you've just made may be canceled by clicking on the NO gadget.TEXT
  41. Otherwise you can save to a file the modification you've made by clicking on the OK gadget. A file requester opens and you must select a drawer and a file name, by typing the names in the corresponding string gadgets. As an alternative you can select the drawer by clicking on one of the 5 gadgets on the right of the requester. When the drawer is selected, the file names of that drawer are displayed sorted by alphabetical order, followed by the sub-directories of that drawer if any. Files and sub-directories can be selected by clicking on their respective names. If you want to go backward in the directory tree click on the "/" gadget.
  42. Modifications are saved under the specified file name when you click on the OK gadget of the file requester. You can cancel anytime by pressing the Cancel gadget.TEXT
  43. ,Click on the windowclose gadget to quit SCM.TEXT
  44. 'There is also a menu featuring 4 items:
  45. - Load: allows you to replace the colors of the currently selected screen with the colors contained in a file previously saved under SCM.
  46. If the number of colors in the file is less than the number of colors of the current screen, only the first colors of the current screen are replaced.TEXT
  47. O- Save: save your modifications to a file under the latest specified file name.
  48. 4- Save as: same action as clicking on the OK gadget.FSCC
  49. :- Quit: same action as clicking on the windowclose gadget.FSCC
  50. Note: do not try to modify the colors of a screen under SCM after this screen has been closed, or you may crash the system. This is because SCM doesn't know about closed screen until you select a new screen with the gadget arrows.FSCC
  51. SCL description
  52. "To run SCL type at the CLI prompt:TEXT
  53. .        SCL -c<file name> [-t<timeout>] [-p<period>]FSCC
  54. JThe filename is mandatory. it can be created using the save option of SCM.TEXT
  55. The timeout is by default quite a long time (more than 68 years should be above Amiga MTBF), but can be changed to a value you specify in seconds.TEXT
  56. kThe period (by default 5 seconds) is the interval of time between 2 screen checking. Specify it in seconds.
  57. 5SCL tries to change the color of the screen whose name appears in the file name specified in the command line. If the screen is not yet opened, SCL waits for it to open, changes its colors, and then exits. The new colors are read from a file which can be created using the screen color modifier utility (SCM).
  58. If the screen is not opened, SCL goes to sleep for a period of time you can specify with the -p option. It defaults to 5 seconds. After this period of time, SCL checks again if the screen is opened and so on.TEXT
  59. RThe time SCL wait for the screen to be opened can be specified with the -t option.TEXT
  60. 9An example to use it (replace Sculpt3D with your choice):
  61. - load Sculpt3D,TEXT
  62. - load SCM,
  63. - find Sculpt3D screen,
  64.  - modify the colors as you like,TEXT
  65. :- save the modification to a file named: "dh0:Sculpt.scm",TEXT
  66. >- create a batch file called Sculpt3D_my_colors, with 2 lines:TEXT
  67.     - Run SCL -cdh0:Sculpt.scm
  68.     - Run Sculpt3D
  69. "- type Execute Sculpt3D_my_colors,TEXT
  70. 8- watch the colors of the Sculpt3D screen being changed.HEAD
  71. >                                         Screen Color ModifierFSCC
  72. 2  JMN                       page 
  73.                   
  74.